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MS-DOS Command Editing, Filtering, 
and Piping 


This chapter describes how to enhance your control of MS-DOS com- 
mands. Chapter 5.1 describes the special MS-DOS editing keys and 
how you can use function keys to redisplay and edit parts of the previ- 
ous command line (the template). 


Chapters 5.2 and 5.3 demonstrate two major processes—filtering and 
piping data. These processes enable you to reorganize and output data 
between files or devices, and to use the output from one command as 
input to another:command in the same command line. 


5.1 Special MS-DOS Editing Keys 


The way MS-DOS uses special editing keys differs from the way in 
which most operating systems handle command input. You do not 
need to type the same sequences of keys repeatedly because the last 
command line is automatically placed in a special storage area called a 
template. 


By using the template and the special editing keys, you can take advan- 
tage of the following MS-DOS features: 
1. You can repeat a command line instantly by pressing two keys. 


2. If you make a mistake in the command line, you can edit it and 
retry the command without having to retype the entire command 
line. 


3. By pressing a special editing key, you can edit and execute a com- 
mand line that is similar to a preceding command line with a 
minimum of typing. 
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Figure 5-1 shows the relationship between the command line and the 
template. 


Command oe ake Special 
Line Editing Keys 


eo 


Command Processor 


(ICOMMAND.COM/ 
VCOMMAND.COM) 


Figure 5-1: The Command Line and the Template 


As shown in the figure, you type a command to MS-DOS on the com- 
mand line. When you press the Return key, the command is automati- 
cally sent to the command processor for execution. At the same time, 
a copy of this command is sent to the template. Once a copy of the 
command is in the template, you can recall the command or modify it 
with the MS-DOS special editing keys. 


Chapter 5.1.1 discusses the command-line editing functions available 


in I mode. Chapter 5.1.2 discusses the command-line editing functions 
available in V mode. Although many of the same functions exist in 
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both modes, in many cases you press different keys to perform these 
functions. 


For more information on the keyboard and how it behaves in I mode 
and V mode, see the PlusPC User’s Guide. 


5.1.1 Command-Line Editing in I Mode 


This section summarizes what the command-line editing keys do in I 
mode. Table 5-1 lists the function keys associated with command-line 
editing in I mode. The examples following the table show you how 
these keys work. 


Table 5-1: The I Mode Editing Functions 


KEY EDITING FUNCTION 

Fl or — Copies one character from the template to the command line. 

F2 Copies characters up to the character specified in the template 
and puts these characters on the command line. 

F3 Sop all remaining characters in the template to the command 
ine. 

DEL Skips over (does not copy) a character in the template. 

F4 Skips over (does not copy) the characters in the template up to 
the character specified. 

ESC Voids the current input; leaves the template unchanged. 

INS Enters/exits insert mode. 

F5 Makes the new line the new template. 

F6 Puts a CTRL-Z (1AH) end-of-file character in the new template. 


BACKSPACE or— _ Backspaces and erases one character from the display line; leaves 
the template unchanged. 
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If you type the following command, MS-DOS displays information 
about the file PROG.COM on your screen: 


dir prog.com(cr) 
This command line is also saved in the template. To repeat the 
command, just press F3; the command is displayed on the screen. 
Then press Return. Notice that pressing the F3 key causes the contents 
of the template to be copied to the command line; pressing Return 
causes the command line to be sent to the command processor for 
execution. 


If you want to display information about a file named PROG.ASM, 
you can use the contents of the template and type: 


< F2 > c(cr) 
where <F2> represents function key 2. Pressing F2 and then C 


copies all characters from the template to the command line, up to but 
not including C. MS-DOS displays: 


DIR PROG. _ 


In the example above, the underline represents your cursor. Now type: 
asm 


The result 1s: 


DIR PROG. ASM_ 


The command line DIR PROG.ASM is now in the template and 1s 
ready to be sent to the command processor for execution. To do this, 
press Return. 
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Now assume that you want to execute the following command: 
type prog.asm 

To do this, type: 
type < INS > < F3 > (cr) 


where <INS> _ represents the INS (Insert) key and <F3> is 
function key 3. As you type, the characters are entered directly into the 
command line and overwrite corresponding characters in the tem- 
plate. This automatic replacement feature is turned off when you press 
the INS key. Thus, the characters “TYPE” and ““PROG.ASM” replace 
the characters “DIR” in the template. To insert a space between 
“TYPE” and “PROG.ASM”’’, you press INS and then the space bar. 
Finally, to copy the rest of the template to the command line, you 
press F3 and then Return. The command TYPE PROG.ASM is then 
processed by MS-DOS, and the template becomes TYPE PROG.ASM. 


If you misspell TYPE as BYTE, you will receive an error message. But 
you can save the misspelled line before you press Return by creating a 
new template with the F5 key: 

byte prog.asm < F5 > 
You can now edit this erroneous command by typing: 

t<F1>p<F3> 
The F1 key (or the — key) copies a single character (in this case, y) 
from the template to the command line. Enter p, then press F3 to copy 


the rest of the template to the command line. The correct command 
line is displayed: 


TYPE PROG. ASM 
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Or you can use the same template containing BYTE PROG.ASM and 
then use the DEL and INS keys to achieve the same result: 


<DEL> <DEL> <F1> <INS>yp<F3> 


To illustrate how the command line is affected as you type, examine 
the keys typed on the left; their effect on the command line is shown 
on the right: 


KEY DISPLAY DESCRIPTION 
< DEL > — Skips over Ist template character 
<DEL > — Skips over 2nd template character 
<FI> T Copies 3rd template character 
<INS>YP TYP Inserts two characters 
<F3> TYPE PROG.ASM Copies rest of template 


Notice that DEL does not affect the command line. It affects the 
template by deleting the first character. Similarly, F4 deletes characters 
in the template, up to but not including a given character. 


5.1.2 Command-Line Editing in V Mode 


This section discusses the command-line editing key functions in V 
mode. These function keys, F1 through F7, are located on the top row 
of your keyboard. 


Table 5-2 summarizes how the command-line editing function keys 


behave in V mode. The examples following the table familiarize you 
with how these keys work. 
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Table 5-2: The V Mode Editing Functions 


KEY EDITING FUNCTION 

Fl or Enters or exits insert mode (toggle). 

F2 Makes the new line the new template. 

F3 Copies one character in the template to the command line. 

F4 Skips over (does not copy) one character in the template. 

F5 Skips over (does not copy) the characters in the template up to the 
character specified. 

F6 Copies all the characters up to the character specified from the template 
to the command line. 

F7 Copies all remaining characters in the template to the command line. 

ALT-X Cancels the line just entered; the template remains unchanged. Also, an 


ALT-X exits insert mode if it is on. 


If you type the following command in V mode, MS-DOS displays in- 
formation about the file PROG.COM on your screen: 


dir prog.com(cr) 


This command line is also saved in the template. To repeat the 
command, press F7. Regardless of the cursor position at the time, the 
whole command line displays on the screen. If you press Return, the 
command line goes to the command processor for execution. 


If you want to display information about a file named PROG.ASM, 
you can use the contents of the template and press: 


< F6 > c(cr) 
where <F6> represents function key 6. Typing F6 and then C copies 


all the characters from the template to the command line, up to but 
not including C. 
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MS-DOS displays: 


; | 


In the example above, the underline represents your cursor. Now type: 
asm 


The result is: 


DIR PROG. ASM_ 


The command line DIR PROG.ASM is now in the template and is 
ready to be sent to the command processor for execution. To do this, 
press Return. 


Now assume that you want to execute the following command: 


type prog.asm 
To do this, type: 
type < Fi > (sp) < F7 > (cr) 


As you type, the characters are entered directly into the command line 
and overwrite corresponding characters in the template. Thus, the 
characters ““TYPE” replace the characters “DIR” in the template. F1 
turns on insert mode. To insert a space between “TYPE” and 
“PROG.ASM”, press Fl and then the space bar. Finally, to copy the 
rest of the template to the command line, you press F7 and then 
Return. The command TYPE PROG.ASM is processed by MS-DOS, 
and the template becomes TYPE PROG.ASM. 
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If you misspell TYPE as BYTE, you will receive an error message. But 
you can save the misspelled line before you press Return by creating a 
new template with the F2 key: 

byte prog.asm < F2 > 
You can edit this erroneous command by typing: 

t<F3>p<F7> 
The F3 key copies a single character (in this case, y) from the template 


to the command line. You then type p, and press F7 to copy the rest 
of the template. The correct command line is displayed: 


TYPE PROG.ASM 


The F4 key skips over one character in the template. The specified 
character does not appear in the new line. The cursor does not move; 
only the template is affected. For example, assume you mistype the 
following command: 

chhdir myfiles(cr) 


To correct this error, type ch and press F4. F4 skips over the second h. 
Then press F7 to copy the rest of the template: 


ch<F4> <F7> 


The result 1s: 


CHDIR MYFILES 
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The F5 key skips over multiple characters in the template. If the 
template does not contain the specified character, nothing is skipped. 
Suppose you enter the following command: 


cd myfiles 


Now you want to change the command to RM MYFILES. Type F5 
and the letter m. Next press Fl to enter insert mode, and type rm 
followed by a space. Press F7 to copy the rest of the command line: 


<F5>m< F1>rm(sp) < F7 > 


The new command is displayed: 


RM MYFILES 


5.2 Filtering Data 


MS-DOS can sort through the data in a text file and arrange it in a dif- 
ferent order. This process is called filtering. These commands filter 
data: 


> FIND searches for a constant string of alphanumeric characters. 


> SORT rearranges the data in the order that you specify in the 
command. Order is predefined by the ASCII collating sequence. See 
Appendix A for an ASCII conversion table. 


> MORE displays one screen of data at a time; press the Return key 
to display another screen of data. See Chapter 6.4 for information 
° on the MORE command. 
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You can use these commands with any MS-DOS files, such as 
VBASICA files. The examples given in this section use the following 
data file. PHNLST.DAT, containing four records of names and phone 
numbers: 


Washington, George 301 328-4370 
Kennedy, John 617 736-2867 

Lee, Robert 703 532-3370 

Lincoln, Abraham 309 473-2800 


You can filter the data by area code with the FIND and SORT com- 
mands. In the following example, FIND searches for a numeric string 
of characters, the 309 area code: 


find “309” b:phnist.dat(cr) 


MS-DOS displays: 


b:phnlst.dat 


Lincoln, Abraham 309 473-2800 


The SORT command can arrange data alphabetically or the reverse, Z 
through A. The following command tells MS-DOS to arrange the 
PHNLST.DAT data records alphabetically and to output the sorted 
data to the screen: 


sort < b:phnist.dat > con(cr) 
The < and > symbols redirect input and output. The < in the 
previous command tells MS-DOS that the file PHNLST.DAT on drive 


B is the input for the SORT command. The > symbol tells MS-DOS 
to send the output (the sorted data) to the display unit (CON). 
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The preceding command displays this sorted data: 


Kennedy, John 617 736-2867 
Lee, Robert 703 532-3370 


Lincoln, Abraham 309 473-2800 
Washington, George 301 328-4370 


You can also tell MS-DOS to create a new file and send sorted data to 
the new file. For example, if you name the file ALPHA.NUM in place 
of CON in the previous example, MS-DOS sends the alphabetized file 
records to ALPHA.NUM on drive B: 


sort < b:phnist.dat > b:alpha.num(cr) 


5.3 Piping Data 


To pipe data means to enter more than one command on a command 
line, separating commands with a vertical bar (| ), the pipe separator. 
By piping commands you can use the output from one command as 
the input for another command. You can combine piping with filter- 
ing to rearrange existing files into new sorted files. 


You can: 


» Filter data from an existing data file and pipe it to a new file or 
other output source, such as the screen (CON) or printer (PRN). 


> Filter columnar data, such as a directory, by column number (the 
screen column where file size, date, or time is listed). 


> Use batch processing to make filtering and piping data even easier. 
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§.3.1 Filtering and Piping Data Files 


Using PHNLST.DAT, the sample file shown in Chapter 5.2, you can 
filter the data by area code. You can then pipe the filtered area codes 
to the AREA.COD file by specifying: 


find “301” b:phnist.dat | sort > b:area.cod(cr) 


The | pipe symbol tells MS-DOS to take the output from the command 
on the left side of the bar and use it as input for-the command on the 
right side of the bar. The > symbol in the command sends all the 
records containing the 301 area code to a new file named AREA.COD. 


The following command uses the >> symbol to append all the 
records containing the 309 area code to the end of the AREA.COD 
file: 


find “309” b:phnist.dat | sort >> b:area.cod(cr) 


To verify that the sorted records are in AREA.COD, specify: 
type b:area.cod(cr) 
If you enter: 
type b:phnist.dat | sort > prn(cr) 
MS-DOS gets the output of the TYPE B:PHNLST.DAT command 


and uses it as input for the SORT command. The SORT command 
sorts the file alphabetically and sends the sorted data to the printer. 
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5.3.2 Filtering and Piping Columnar Data 


Using the SORT command, you can pipe and sort columns of data. 
For example, if you type: 


dir | sort /+ 16 | more(cr) 


MS-DOS pipes the output of the DIR command as input to the SORT 
filter command. The sorting starts in column 16 of the directory 
display (file size). MS-DOS sends the directory, sorted by file size, to 
the display unit. MORE displays the directory one screen at a time 
with the message --MORE-- at the bottom of the screen. You can 
display the next screenful of directory information by pressing Return. 


§.3.3 Filtering and Piping Batch Files 


You can use filtering and piping in batch files. The next example 
creates a batch file PHONES.BAT that searches for a value (the %l 
parameter) in the PHNLST.DAT file, sorts the records containing that 
value, and displays those records onscreen: 


copy con phones.bat(cr) 

find “%1” phnist.dat | sort > (cr) 

“Z(cr) 
You can use PHONES.BAT to search for any area code you want. 
Type PHONES and the area code you want to have sorted from the 
PHNLST.DAT file, such as: 

phones ”301”(cr) 


All the records from PHNLST.DAT with area code 301 are displayed. 
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MS-DOS Commands 


This chapter presents an overview of MS-DOS commands. Chapter 6.1 
lists and describes the two types of MS-DOS commands (internal and 
external) as well as the batch commands (internal commands used in 
batch files). Chapter 6.2 describes the notation used in the syntax of 
commands in this manual. 


Chapter 6.3 describes the special commands you use to alter the sys- 
tem configuration contained in the ICONFIG.SYS/VCONFIG.SYS 
files. Finally, Chapter 6.4 presents the syntax of all the MS-DOS com- 
mands (excluding EDLIN and the system configuration commands). 
Commands are listed alphabetically and examples are included for 
most commands. 


6.1 Overview of Commands 


You use the MS-DOS commands to set up and manage your files and 
directories, the diskettes that contain your files, and the devices 
attached to your computer. This overview describes some of the MS- 
DOS commands and what you can do with them. For a complete list- 
ing of the commands, see Chapter 6.4. 


You use the MS-DOS file commands to: 


> Copy, delete, rename, display, or verify files (COPY, DEL, REN, 
TYPE, and VERIFY) 


> Copy the operating system files from one drive to a VICTOR for- 
mat diskette or fixed disk volume (RETROSYS) 


> Change the file format or rearrange the file contents (SORT and 
FIND) 
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> Queue a list of files for printing (PRINT) 


>» Create batch files and control their execution (COPY CON, ECHO, 
SHIFT, and so on) | 


You use the MS-DOS directory commands to: 
> Display the directory of a diskette (DIR) 
>» Create or remove directories (MKDIR and RMDIR) 


> Change from one subdirectory to another, or check your position in 
the directory hierarchy (CHDIR) 


You use the MS-DOS disk commands to: 
>» Prepare blank diskettes for MS-DOS use (FORMAT). 
> Copy the contents of one diskette to another (DISKCOPY). 


> Check the amount of space on a diskette, and check a directory for 
errors in file storage (CHKDSK) 


> Recover data from a bad sector on a disk (RECOVER) 


The MS-DOS device commands (CLS, CTTY, CLST, and CAUX) 
control the CRT, your printer, and your disk drives. These commands 
display information about your diskettes and disk drives. They can 
also change devices, such as changing output from the screen to the 
printer. 


The system configuration commands (such as BREAK, BUFFERS, 
and DEVICE) enable you to control parts of the operating environ- 
ment. All of these commands are used in the ICONFIG.SYS and 
VCONFIG.SYS files, which set up the environment when MS-DOS 
loads into memory. The BREAK command can also be used interac- 
tively. See Chapter 6.3 for a description of the configuration com- 
mands. 


Other MS-DOS commands affect the way the operating system works. 


For example, there are commands to set up constants in the operating 
environment and commands to change the system command prompt. 
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6.1.1 Internal and External Commands 


There are two types of MS-DOS commands: internal and external. 
Internal commands are a set of commands that exist within MS-DOS. 
External commands are stored on disk as separate files. External com- 
mands have either a .COM or .EXE file extension. External commands 
are also known as utility programs. 


The command processor program interprets and processes all the MS- 
DOS commands, both internal and external. The command processor 
is in the system files ICOMMAND.COM and VCOMMAND.COM 
contained on the MS-DOS system diskette. When you load MS-DOS, 
ICOMMAND.COM, VCOMMAND.COM, or any command proces- 
sor file named in ICONFIG.SYS/VCONFIG.SYS is automatically 
loaded into memory. 


The internal commands are part of the ,ICOMMAND.COM/ 
VCOMMAND.COM files. External commands, on the other hand, 
must be individually loaded into memory by ICOMMAND.COM or 
VCOMMAND.COM each time you use that command. The internal 
commands remain in memory as long as ICOMMAND.COM or 
VCOMMAND.COM is 1n memory. 


The MS-DOS command interface is illustrated in Figure 6-1. 
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Command ICOMMAND.COM/ 
Line — > VCOMMAND.COM 


Memory 


(External commands 
loaded and executed by 
ICOMMAND.COM/ 
VCOMMAND.COM) 


Figure 6-1: MS-DOS Command Interface 


Internal Commands 


The internal commands are: 


Internal 
Commands 


Disk Space 


>» External commands 
(.COM and .EXE files) 


> Batch files (.BAT files) 
>» Data files 


BREAK CTTY HISTORY SET 
CAUX DATE MKDIR TIME 
CHDIR DEL PATH TYPE 
CLS DIR PROMPT VER 
CLST ERASE REN VERIFY 
COPY EXIT RMDIR VOL 


These internal commands are not displayed in the directory. When 
you enter an internal command, it executes immediately whenever 
ICOMMAND.COM/VCOMMAND.COM is in memory. 
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Some internal commands can use the pathing system described in 
Chapter 3 to obtain files from the MS-DOS subdirectory system. These 
commands are COPY, DEL, DIR, CHDIR, ERASE, MKDIR, 
RMDIR, TYPE, and PATH. 


External Commands 


The external commands are: 


ASSIGN EXESIZE MODCON SEARCH 
CHKDSK FGREP MODE SORT 

COMP FILCOM MORE TAIL 
CONCAT FIND MV TREE 
DISKCOMP FORMAT PRINT VCOMMAND 
DISKCOPY GRAPHICS RECOVER WC 

EDLIN ICOMMAND RETROSYS 

EXE2BIN LS SDCOPY 


The command descriptions in Chapter 6.4 include all the external 
commands except EDLIN (see Chapter 4). 


Like all programs, the external commands are stored in command files 
on disk. You can identify them by the extension .COM or .EXE. You 
should keep all the MS-DOS commands in the subdirectory structure 
provided for you on your PlusPC distribution diskette. 


Before you can successfully issue an external command, MS-DOS has 
to know where to locate the command file. Use either the CHDIR 
command to change to the directory where you keep your command 
files, or use the PATH command to specify a path to that directory. 
When you enter the command, MS-DOS reads the command from 
that directory. If MS-DOS cannot find the command file, you see this 
message: 


Bad command or filename 
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6.1.2 Batch Commands 


Batch commands are used only in batch files (see Chapter 2). Because 
the batch commands are internal commands, ICOMMAND.COM/ 
VCOMMAND.COM must be loaded in main memory whenever you 
run a batch file that uses any of these commands: 


ECHO IF-EXIST 

FOR-IN-DO PAUSE 

GOTO REM 
SHIFT 


6.2 Command Syntax and Notation 


Descriptions of all the MS-DOS commands are listed alphabetically in 
Chapter 6.4. In each description, the syntax or format for each com- 
mand is given first. Then the elements of the command are defined, 
and examples are presented to show how to use the commands. In 
examples, the entire command line is lowercase except for elements 
that require uppercase, such as proper nouns or command switches 
that are not valid in lowercase. 


The notation used for command syntax is as follows. 


COMMAND NAMES 
are shown in uppercase. You can enter command names in upper- 
or lowercase, however. 


LITERAL PARAMETERS 
are shown in uppercase. These are parts of a command that must be 
entered literally if you want to include them. You can enter the 
parameters in upper- or lowercase, except as noted in the command 
descriptions. 
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variable parameters 
are shown in lowercase. You can enter command parameters in 
upper- or lowercase. 


[] 


enclose optional parameters. 


is an ellipsis indicating that you can repeat the preceding parameter. 


filename.ext, drivename 
represent the type of entry you must make. For example, when you 
see the word filename, you must enter the name of a specific file 
(with or without wild-card characters). 


path 
is the full or relative path through the subdirectory hierarchy to the 
subdirectory or file named in the command. In this chapter, the 
syntax for paths is: 


[drivename:][[\]directoryname[\directoryname...]] 


If the file or subdirectory you want is in the current directory on the 
default drive, you can omit the directory and drive names. The first 
\ in a path always refers to the root directory. Each additional 
\directoryname refers to a lower level subdirectory. Path syntax is 
fully described in Chapter 3. 


indicates that the parameter (such as /C) is a switch. A switch causes 
MS-DOS to process the command as altered by the specified switch. 
When you enter a switch in the command line, separate it from 
commands and other switches with a space. 


indicates that data is to be piped (see Chapter 5). The output gen- 
erated by the command on the left side of the bar is sent as input to 
the command on the right side of the bar. Separate the | from other 
command elements with a space. 
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< 
indicates that the input to the preceding command is to come from 
a source other than the keyboard. Enter a space before and after the 
in 


> 
indicates that the output from the preceding command is to be sent 
to a file or device (such as the printer). Enter a space before and 
after the >. 


2S 
indicates that the output from the command is to be sent to the end 
of the file named in the command. Separate the >> from other 
command elements with a space, but do not type a space between 
the >s. 


(cr) 


indicates the Return key. 


(sp) 
indicates the Space bar. 


indicates the CTRL (Control) key. A CTRL-key sequence (pressing 
CTRL and another key) is shown as CTRL- and the letter or 
number, such as CTRL-C. 


You must include all punctuation (commas, colons, or question 
marks), symbols \, |, <, and >>, and blank spaces where shown, 
except for [ ], which indicate optional parameters, and the ellipsis. The 
ellipsis indicates that a parameter can be repeated. 


NOTE: Because the symbols \, |, <, and > are literal parts of MS- 
DOS commands, they cannot be used in a filename. If you have any 
existing files that have \, |, <, or > in their filenames, you must 
rename the files before you can use them with MS-DOS version 2.1 or 
later. Use a previous version of MS-DOS to rename the files. 
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6.3 System Configuration Commands 


In many cases, there are installation-specific settings for MS-DOS that 
need to be configured at system startup. An example of this is a stan- 
dard device driver, such as an online printer. 


The MS-DOS configuration file (ICONFIG.SYS/VCONFIG.SYS) 
allows you to configure your system. With this file, you can add device 
drivers to your system at startup. The configuration file is an ASCII file 
that has certain commands for MS-DOS startup (boot). The boot pro- 
cess is as follows: 


1. The disk boot sector is read. This contains enough code to read 
MS-DOS code and the installation’s BIOS (machine-dependent 
code). 


2. The MS-DOS code and BIOS are read. 
3. A variety of BIOS initializations are done. 


4. A system initialization routine reads the configuration file, if it 
exists, to perform device installation and other user options. Finally, 
it executes the command interpreter, finishing the MS-DOS boot 
process. 


Chapter 6.3.1 describes the commands that you can use in the 
configuration file. You do not need to change this file unless you want 
to alter the operating environment to fit your needs. 


When MS-DOS loads into memory, it checks the root directory for a 
system configuration file named ICONFIG.SYS/VCONFIG.SYS. This 
file contains system initialization routines that tell MS-DOS: 


> Whether a reference to a device requires a pathname (AVAILDEV) 
> When to allow CTRL-C to interrupt operations (BREAK) 


> The number of buffers to allocate for input and output data 
(BUFFERS) 
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» The standards associated with particular countries (COUNTRY) 
» The device drivers to be installed (DEVICE) 

>» The number of files that can be open at the same time (FILES) 
» The name of the command processor to be loaded (SHELL) 

> The symbol that indicates a command parameter (SWITCHAR) 


To change the ICONFIG.SYS or VCONFIG.SYS file, use any text edi- 
tor that operates under MS-DOS, such as EDLIN. You can also create 
a new configuration file with the COPY command. The changes you 
make to the file become effective the next time you load MS-DOS. 


6.3.1 Descriptions of Configuration Commands 


This section presents the syntax for the system configuration com- 
mands that can appear in ICONFIG.SYS/VCONFIG.SYS. 
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AVAILDEV 


AVAILDEV = TRUE(cr) 
or 
AVAILDEV = FALSE(cr) 


The default is AVAILDEV = TRUE. This command controls 
whether device names (such as CON and LST) refer only to devices or 
can be used as filenames. The device files are described in Chapter 2.2. 
The default setting means MS-DOS reads both the following names as 
the device name LST. LST is used to represent any device name: 


\DEV\LST 
LST 


If AVAILDEV = FALSE, MS-DOS reads only \DEV\LST as the de- 
vice name LST. This means that LST by itself refers to a file in the 
current directory with the same name as the device LST. Of course, 
the file might or might not exist. 


BREAK 
BREAK = ON(cr) 
or 
BREAK = OFF(cr) 


The default, BREAK = OFF, tells MS-DOS to check for a CTRL-C 
or CTRL-BREAK interrupt only during screen, keyboard, printer, or 
asynchronous communication adapter operations. BREAK = ON 
tells MS-DOS to check for a CTRL-C or CTRL-BREAK interrupt dur- 
ing all operations, including whenever MS-DOS is processing a pro- 
gram. You can also change the setting by issuing the interactive 
BREAK command, described in Chapter 6.4. If you set BREAK = 
ON, you can abort programs by typing a CTRL-C or CTRL-BREAK. 
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BUFFERS 


BUFFERS = xx(cr) 


where xx iS a number between | and 99. The default value is 3. A 
buffer is the amount of memory allocated for the reading of data from 
disk and the writing of data to disk. If your application does sequential 
access to the data on disk, you can use a small number of buffers. If 
you are using a database with random access, 10 to 20 buffers is ade- 
quate. A larger number of buffers can speed disk access. If the number 
of buffers gets too large, however, you use more memory and slow 
operations. 


COUNTRY 


COUNTRY = nn(cr) 


where nn is a number between 1 and 99. The COUNTRY command 
selects configuration standards according to the given country code. 
Some of the standards affected are the currency separator and the for- 
mat for the DATE command (such as listing the month first or listing 
the day first). 


The numbers you can use with COUNTRY are the country’s tele- 
phone code, for example: 


1 USA 
33 France 
44 United Kingdom 
46 Sweden 
49 Germany 
81 Japan 
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DEVICE 


DEVICE = [path]filename.ext[parameters](cr) 


This command installs the device driver from the specified file. The 
default is the device drivers for the standard screen, keyboard, printer, 
auxiliary device, floppy disk drive, and fixed disk. DEVICE also lets 
you include device drivers that you have written. For each device 
driver, you must include a DEVICE command in the ICONFIG.SYS/ 
VCOMFIG:SYS file. 


path 
is the path to the device driver file, including drive and subdirectory 
names where necessary. 


filename.ext 
is the name of the file containing the device driver. 


parameters 
is a list of initial settings for a device driver. Use the MODE com- 
mand to set serial ports. See MODE in this chapter for more infor- 
mation. 

The default device drivers for your input/output ports are: 

> AUX—for serial port 1, also known as COM1. 

> COM2—for serial port 2. 

> PRN—for the parallel port. 
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FILES 


FILES = xx(cr) 


where xx is a number between | and 99. The default value is 8. This 
command specifies the number of files that can be opened con- 
currently. For each additional file above 8, the size of the resident por- 
tion of MS-DOS increases by 39 bytes per file. The amount of memory 
available for the application program is reduced by the number of 
bytes allocated to the number of opened files. Note: Specifying a value 
less than 8 might prevent some system operations, such as filtering and 
piping (see Chapter 5.2). 


SHELL 


SHELL = [path]filename.ext [comspec path][/P](cr) 


SHELL names the command processor to be loaded when MS-DOS 
starts. The default is ICOMMAND.COM/VCOMMAND.COM. 
ICOMMAND.COM is for I mode; VCOMMAND.COM is for V 
-mode. Do not alter these files unless you are a systems programmer 
who has created a command processor for your own applications. If 
you replace ICOMMAND.COM or VCOMMAND.COM with your 
own command processor, you must provide for the hex 22, 23, and 24 
interrupts, the internal commands, the batch processor, and the EXEC 
function call. 


path 
is the path through the directory hierarchy to the file containing the 
command processor. Include the drive name and subdirectory 
names where necessary. 


filename.ext 
is the name of the file containing the command processor. 
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/P 
tells the command processor that it is the first program to be run by 
MS-DOS. The P must be preceded by the correct symbol for com- 
mand parameters (see SWITCHAR). 


comspec path 

is a path through the directory system. It is appended to the name of 
the command processor and SET into the MS-DOS environment as 
““COMSPEC”’. The operating system uses COMSPEC to locate the 
command processor. You can display the current COMSPEC path 
with the SET command. If omitted from the SHELL command in 
ICONFIG.SYS/VCONFIG.SYS, the COMSPEC path is the root 
directory on the default drive. 


The following example uses VCOMMAND within a SHELL com- 
mand line ina VCONFIG.SYS file: 


shell = a:\bin\vcommand.com(cr) 


This SHELL command tells MS-DOS that the command processor is 
the fle VCOMMAND.COM on drive A in subdirectory BIN. 


SWITCHAR 
SWITCHAR = x(cr) 


where x can be any alphanumeric character. The default switch charac- 
ter is /. This command specifies the symbol that indicates command 
switches to MS-DOS. For example, to add the V switch to the COPY 
command, you would type /V. 


By default, the MS-DOS path-separator character is the backslash (\), 
while the slash (/) is the switch character. If you set a different switch 
character with the SWITCHAR command, the path separator becomes 
the slash (/). 
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For example, if VCONFIG.SYS contains this command: 
switchar = - 


you must use the hyphen to introduce command switches (such as -V), 
and you must use the slash to separate parts of pathnames (such as 
/MGR1/TOM). 


6.3.2 Sample Configuration File 
A typical configuration file might look like this: 


break = on 

buffers = 10 

files = 10 

switchar = / 

shell = a:\bin\vcommand.com 


This VCONFIG.SYS file does the following: 

> Sets the CITRL-C interrupt on 

> Adds 10 additional sector buffers to the system list 

> Allows 10 files to be open at once 

> Defines the syntax notation for command parameters as a slash 


> Begins execution of the shell (the top-level command processor) 
from VCOMMAND.COM in the subdirectory BIN on drive A 


6.4 Command Descriptions 


This section presents descriptions of the syntax and examples of usage 
for the MS-DOS commands. Each command is listed alphabetically. 
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ASSIGN 


ASSIGN [x = y...](cr) 


ASSIGN is an external command that instructs MS-DOS to use a drive 
other than the one requested. In effect, physical drive X is converted to 
logical drive Y. Note that when you use this command, you do not 
include a colon after the drive name. 


X 
is the physical drive. 


y 
is the logical drive assignment. 


When you use the ASSIGN command without any parameters, all 
drive assignments are reset to normal. 


With the ASSIGN command, you can use applications programs 
designed to use only drives A and B. For example, an applications pro- 
gram that offers only A and B as choices can also be used with drive C. 


The ASSIGN command should be used only in such applications pro- 
grams. It must never be used with the PRINT command or in normal 
MS-DOS operations because this can hide device-type commands and 
programs that require actual disk operation. DISKCOPY and 
DISKCOMP ignore all drive reassignments. 


When you enter the following command, procedures previously 
assigned to drive A are performed on drive B. For example, if you 
enter this command and then a directory command, MS-DOS displays 
a directory listing of the files located in drive B. 


assign a= b(cr) 
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The following command line causes procedures assigned either to drive 
A or to drive B to be performed on drive C: 


assign a=c b=c(cr) 
If you specify ASSIGN without any parameters, all previous assign- 
ments are undone; physical drive A is logical drive A, physical drive B 


is logical drive B, and so on: 


assign(cr) 


CTRL-C Interrupt (BREAK) 


BREAK [ON](cr) 
or 
BREAK [OFF](cr) 


BREAK is an internal command that lets you use CTRL-C as a system 
interrupt (BREAK ON) or without the interrupt effect (BREAK OFF) 
when MS-DOS is processing a program. When BREAK is ON, typing 
CTRL-C interrupts the current operation and redisplays the system 
prompt. Enter BREAK without parameters to check the status of the 
interrupt function. MS-DOS displays the following, where xx is “on” 
or “off.” 


BREAK iS xx 


ON tells MS-DOS to allow a CTRL-C interrupt at any time during the 
processing of a program. OFF tells MS-DOS to allow a CTRL-C inter- 
rupt only during the operation of the keyboard, printer, or an auxiliary 
device. The default 1s OFF. 
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Change Directory (CHDIR) 


CHDIR [..] [path] [/A](cr) 


CHDIR is an internal command that changes your position in the 
directory hierarchy or displays the name of the current subdirectory. 
You can abbreviate the command name to CD. CHDIR is also de- 
scribed in Chapter 3. 

You use this command to: 

> Move to a subdirectory from any other directory. 

> Move to a directory level above this one. 

> Return from a subdirectory to the root directory. 

> Display the name of the directory you are using. 

> Display the names of the working directories on all the drives in the 


system. 


CHDIR without parameters displays the directory you are currently 
using. For example, if you are in a directory called CMD in the default 
drive and specify: 

chdir(cr) 


MS-DOS displays: 
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Moves you to the directory above the one you are currently using. 
You can move up two directory levels by specifying: 


cd ..\..(cr) 


/A 
displays the name of the current directory on each drive. Entering 
CHDIR /A tells you the paths to the default directories. This 
CHDIR command is useful when you are copying files from one 
drive to another. When you enter the COPY command, you can 
omit the paths for files you are copying from or to the default direc- 
tories. 


path 
is the path through the directory system to the subdirectory level 
you want. Each directory name is the name of a directory created 
with the Make Directory (MKDIR) command. For example, the fol- 
lowing command looks for the EDFILES subdirectory three levels 
below the root directory: 


chdir \mgr1.nam\cmd\edfiles(cr) 


If you specify a directory name without the \ parameter, MS-DOS 
looks for the directory name in the current directory. In the previ- 
ous example, if you are in the CMD subdirectory and you want to 
access EDFILES, you can enter: 


chdir edfiles(cr) 


instead of the path, \MGR1I.NAM\CMD\EDFILES. MS-DOS 
looks in the current directory, CMD, for the EDFILES subdirectory. 


Entering \ without a directory name refers to the directory at the 
top of the directory hierarchy, the root directory. This CHDIR com- 
mand returns you to the root directory: 


chdir \(cr) 
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Check Disk (CHKDSK) 


CHKDSK [drivename:][filename.ext][ > filename.ext] [/F] [/V](cr) 


CHKDSK.COM is an external command that scans the directory 
hierarchy of the diskette in the specified drive for consistency. If 1ncon- 
sistencies are found, MS-DOS displays error messages and a status 
report. 


If you enter CHKDSK without parameters and if the diskette in the 
default drive contains errors, MS-DOS responds: 


Errors found, F parameter not specified. 
Corrections will not be written to disk. 


n lost clusters found inn chains 
Convert lost chains to files (y/n)? 


where the first ” is a number. 


If you respond with Y, MS-DOS tries to convert the lost chains to files, 
but cannot because you did not use the /F parameter in the command 
line. If you respond with N, MS-DOS displays the amount of memory 
that would be freed. 


drivename 
is the name of the drive containing the disk that you want to check. 
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filename.ext 
is the name of the file you want to check. Use wild-card characters 
to refer to more than one file. For example, *.* reports extents (con- 
tiguous space on disk reserved for a file) for all files in the current /“™ 
directory after a normal consistency check is made. You can copy 
and rename files with many extents to restore them to a contiguous 
state. 


> filename.ext 
redirects output from the CHK DSK command to the specified file. 


/F 
automatically reports to you when: 


> There is an allocation error. CHKDSK fixes the error by adjust- 
ing the size. 


» There is a disk error during the reading of the File Allocation 
Table (FAT). 


> There is a disk error during the writing of the File Allocation 
Table (FAT). 


>» The file for the specified filename contains noncontiguous blocks. 


> The first cluster (file attributes, password, allocation, extent, and 
statistical information) number is invalid and the file entry is 
truncated. CHKDSK fixes the error by releasing the allocation 
units assigned to that file. 


» A Change Directory command for the specified filename cannot 
be done because a subdirectory cannot be processed. 
You must correct the error when CHKDSK encounters: 


> An incorrect MS-DOS version. You cannot run this version of 
CHKDSK on MS-DOS versions lower than 2.1. 


> Insufficient memory. Processing cannot continue. There is not 
enough memory in the processor unit for CHKDSK to process 
the disk. 
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> An invalid current directory. Processing cannot continue. Restart 
the system and reissue the CHK DSK command. 


>» A Change Directory command that cannot be made to the root 
directory. Processing cannot continue. The disk is a bad disk. 
Restart MS-DOS and issue the RECOVER command. 


> Cross-linked files. The same data block is allocated to more than 
one file. Use the COPY command to copy the files you want to 
keep. Check the copies for accuracy, then delete the files that are 
cross-linked. 


>» A non-MS-DOS disk. You are prompted to respond yes (Y) or 
no (N) if you want CHKDSK to continue processing. 


> Insufficient room in the root directory. You are prompted to 
erase the files in the root directory and reissue the CHKDSK 
command. 


> An unrecoverable error in the directory. You are prompted to 
respond yes (Y) or no (N) to convert the directory to a file. If you 
respond Y, you can fix the directory yourself or delete it. 


> Lost allocation units. Lost allocation units are often called 
“orphans.” Usually orphan allocation units occur when you do 
not close a file correctly (created, written to, but not closed). You 
can either free the orphan allocation units or recover them. A 
CHKDSK recover operation writes orphan allocation units to 
files in the root directory of the disk. If there is not enough room 
on the disk to write all the orphan files, delete some files, and run 
CHKDSK again. 


/V 


displays a trace (a record of the series of events as they occur) of the 
files and directories during the CHKDSK processing. 
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The following example checks the diskette in drive B for consistency 
and issues a status report: 


A>chkdsk 


620544 total disk space 
63488 in 2 hidden files 
2048 in 1 directories 
251568 in 16 user files 


317440 available on disk 


A'T2976 total memory 
458576 free 


Clear Screen (CLS) 


CLS(er) 


CLS is an internal command that clears the CRT screen and re- 
displays the system prompt. 
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Compare Files (COMP) 


COMP [drivename:][path][filename[.ext]] 
[drivename:][path][filename[.ext]](cr) 


COMP is an external command that compares the contents of one set 
of files to the contents of another set of files. 


drivename:path\ filename.ext 
The first parameter is the primary file, and the second is the secon- 
dary file. These files can be on the same drive or on different drives, 
in the same directory, or in different directories. 


Wild-card characters can be used in either of the filenames and exten- 
sions. If you specify only the drivename and the path, and do not 
specify a filename, MS-DOS assumes a filename of *.*. 


To compare identical files in two different directories on two different 
drives, enter a command similar to this: 


comp a:\dir1\*.c b:\dir2\dir3(cr) 
Each file located in the directory DIR1 on drive A and having a .C 
extension is compared to a file with a matching filename and extension 
and located on drive B in the path DIR2\DIR3. 


As each file is compared, its pathname and filename are displayed. 


If the files being compared have different lengths, MS-DOS displays 
the following message, and no comparison takes place: 


Files are of different sizes. 


MS-DOS Commands 6-25 


If information in the two files being compared is found not to match, 
the differences are displayed as follows: 


Compare error at offset nnnnnn 


File l1 - xx 
File 2 - xx 


where nnnnnn is the number of bytes from the beginning of the file to 
the byte where the files differ. 


Up to ten compare errors can be reported for any given file. If there 
are more than ten errors, MS-DOS assumes that further comparison is 
useless, and it goes on to the next file. 


If no compare errors are found, the following message is displayed: 


Files compare OK 


Certain applications programs create directories that always record file 
size in multiples of 128. Therefore, the number of information bytes in 
a file might be somewhat less than is indicated in the directory. In such 
cases, the information bytes in the two files might compare, but the 
COMP command might find differences in the non-usable (filler) por- 
tion of the file that follows the information bytes. If this occurs, MS- 
DOS displays the following message: 


EOF mark not found. 
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Concatenate and Output Files (CONCAT) 


CONCAT [files or directories](cr) 


CONCAT.EXE is an external command that concatenates (combines) 
a list of files and displays their contents. The concatenated files are sent 
to the standard output device, the console, but are not saved on disk 
unless you include the > redirection symbol to send the output to a 
disk file (shown in the first example that follows). 


files or directories 
is a list of subdirectory names and/or filenames to be operated on. If 
you do not specify files or directories, input is taken from the key- 
board or from redirected input. 


For example, the following command concatenates the TOD.ASM and 
ATC.ASM files in the current directory. The > symbol sends the 
combined files to the file BACKUP. 

concat tod.asm atc.asm > backup(cr) 
You can also use CONCAT to create files. This command takes any 
following keyboard input (up to CTRL-Z Return) and outputs it to the 
disk file JUNK: 

concat > junk(cr) 
The following command displays the contents of all files in the 
\TEMP subdirectory on the default drive and all files with extension 
.PLM in the current directory: 


concat \temp *.pim(cr) 
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Copy Files (COPY) 


COPY [path]filename.ext [/A] [/B] [+ [path]filename.ext [/A] [/B]...] 
[path][filename.ext] [/A] [/B] [/V](cr) 


COPY is an internal command that copies one or more files from a 
source file to a destination file. The source file is the file you want to 
copy. The destination file is the file to which you want to copy your 
source file. If you do not specify a destination drive, your file is copied 
to the current or default drive. 


path 
is the path through the directory hierarchy to the source or destina- 
tion file. The path includes the drive name and subdirectory names 
as necessary. 


filename.ext 
is the name defined when the file was created. It can also be the 
name of a new file created during the COPY operation. 


To copy a file to the default drive, specify the drive containing the 
source file, then the filename. After this file copy, the copy in the 
default drive has the same name as the source file. For example, this 
command copies the file from drive B to the default drive (drive A) 
and gives it the same name: 


copy b:filename(cr) 
The copy 1s made to the current directory of the default drive. 
To copy the file from the default drive to another drive, specify the 
command name, the name of the file to be copied, and the name of 
the drive. For example, this command copies the file in the default 


drive to drive B and gives it the same name: 


copy filename b:(cr) 


6-28 MS-DOS 2.1 Reference 


Using only filename parameters, you can: 


> Copy a source file from another drive to a destination file on the 
default drive and keep the same filename: 


copy b:chkdisk.bat(cr) 


> Copy a source file from the default drive to a destination file with 
the same name on a different drive: 


copy chkdisk.bat b:(cr) 


> Copy a source file on the default drive to a destination file on the 
same drive and rename the file: 


copy chkdisk.bat newfile(cr) 


The CHKDISK.BAT file is copied on the default drive and 
renamed NEWFILE. 


> Copy a source file from the default drive to another drive and 
rename the file: 


copy chkdisk.bat b:newfile(cr) 


> Copy a source file from a specified drive to the same drive and 
rename it: 


copy b:chkdisk.bat newfile(cr) 


The file CHKDISK.BAT on drive B is copied to drive B and 
renamed NEWFILE. 


concatenates files (links them together). MS-DOS adds a file or files 
to the end of the first specified file and puts the result in either the 
first file or the destination file that you name. For example, this 
command adds the file called PLUS.FIL to the end of ONE.FIL and 
puts the result in ONE.FIL: 


copy one.fil + plus.fil(cr) 
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The next two examples put the result of the concatenated files into 
another file: 


copy one.fil + plus.fil big.fil(cr) 


The contents of the file PLUS.FIL are added to the end of ONE.FIL 
and the result is renamed BIG.FIL. 


copy one.fil + plus.fil + b:next.fil big.fil(cr) 


The contents of the file NEXT.FIL on drive B are added to the end 
of the file PLUS.FIL on the default drive. The resulting file is added 
to the end of ONE.FIL on the default drive. Finally, the destination 
file is called BIG.FIL. 


You can concatenate files using wild-card characters: 

copy *.ist + *.ref combin.fil(cr) 
This command searches for and combines all the files with exten- 
sions .LST and .REF. The result of the concatenation is put into 


COMBIN.FIL. FILE1.LST is combined with FILE1.REF and the 
result is put in COMBIN.FIL. 


The following command combines FILE1.LST with FILE1.REF to 
form FILE1.FIL. ABC.LST combines with ABC.REF to form 
ABC.FIL, and so on. 

copy *.lst + *.ref *.fil(cr) 


This command can produce an error if ALL.LST already exists: 


copy *.ist + all.Ist(cr) 
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As each source filename is found, MS-DOS compares the name 
with the destination filename. If the names are the same, the source 
file is skipped and MS-DOS displays: 


Content of destination lost before copy 


Further concatenation continues normally. 


_ You can, however, add all the files with extension .LST to the file 
ALL.LST: 


copy all.lst + *.Ist(cr) 


/A 
specified with the source file causes the file to be processed as an 
ASCII (text) file. The file is copied to the first end-of-file character 
(CTRL-Z for I mode, or ALT-Z for V mode). The CTRL-Z and the 
rest of the file are not copied. For example: 


copy file.txt /a memo.txt(cr) 
If there is a CTRL-Z within FILE.TXT, the CTRL-Z is removed 
when FILE.TXT is copied to MEMO.TXT. MEMO.TXT contains 
only one CTRL-Z, the last character of the file. 


/A specified with the destination file puts an end-of-file character at 
the end of the file. 


/A is the default when you concatenate files using COPY. 
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/B 
specified with the source file copies the entire file to the physical 
end-of-file defined by the directory file size. For example: 


copy b:new.fil /b cop.fil /a(cr) 


In the preceding command, /B on the source file keeps the end-of- 
file mark (CTRL-Z), and /A on the destination file inserts a CTRL- 
Z. If you specify /B with the eoonanen file, CTRL-Z is not placed 
at the end of the file. 


By default, MS-DOS concatenates files as ASCII (text) files. A 
CTRL-Z (1A in hexadecimal) in the file is interpreted as an end-of- 
file mark. 


When you want to combine binary files, use /B. /B forces the COPY 
command to use the physical end-of-file defined in the directory. /B 
remains in effect until MS-DOS encounters another /A or /B. For 
example, this command concatenates COP.FIL to the end of 
BIN.FIL and places the result into BIN.FIL as a binary file: 


copy /b bin.fil + cop.fil(cr) 


The COPY command is not a linker; object modules cannot be 
combined into an .EXE or a .COM file. 


/V 
is a command switch that tells MS-DOS to verify that the sectors 
written on the destination disk are recorded correctly. Use this 
switch to check that critical data is copied accurately. 


When you use /V, COPY performs more slowly because extra time 
is needed to verify the COPY operation. 
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om 


You can also use reserved device names (see Chapter 2.2.2) in a COPY 
command. For example, you can copy your keyboard input into a disk 
file with COPY CON: : 


A>copy con text.fil(cr) 
This is a text file(cr) 


After you press CTRL-Z (*Z) and Return, the COPY ends and the file 
is saved as TEXT.FIL. 


Change Input/Output Devices 
(CAUX, CLST, CTTY) 


CAUX [devicename](cr) 
CLST [devicename](cr) 
CTTY [devicename](cr) 


CLST, CAUX, and CTTY are internal commands that define the de- 
vices (or device drivers) in your system. CAUX controls the auxiliary 
input/output device; CLST controls the list device (printer); CTTY 
controls the console device (keyboard and screen). If you enter one of 
these commands without specifying a device name, the current device 
driver is displayed. 
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devicename 
is the name of a device driver. You must use a valid device name 
for a device driver that was loaded in your MS-DOS or from a 
DEVICE command in your ICONFIG.SYS or VCONFIG.SYS file. 
MS-DOS installs the following device drivers: 


PRN is the list device for CLST 
AUX is the auxiliary I/O device for CAUX 
CON is the console I/O device for CTTY 


To prevent confusion between device names and filenames, precede 
device names with \DEV\. For example, CTTY = CON is equivalent 
to CTTY = \DEV\CON. 


To select an alternate device driver, type its device name with the 
appropriate command, such as: 

clst fastprtr(cr) 

caux cardrdr(cr) 

ctty remote(cr) 
You can change the port used for the list output by using one of these 
device names with CLST: 


AUX or COM 1 to select serial port 1 
COM2 to select serial port 2 
LPT1, LST, or PRN to select the parallel port 


For more information about your system’s device drivers, see the 
DISKID file on your system diskette. 


6-34 MS-DOS 2.1 Reference 


Current Date (DATE) 


DATE [mm/dd/yy](cr) (in American operating systems) 
Or 


DATE [dd-mm-yy](cr) (in European operating systems) 


DATE is an internal command. MS-DOS records the date in the 
current directory for every file that you create or change. If you enter 
the DATE command without parameters, MS-DOS displays the day 
and the numeric representation for the month, the day, and the year 
last set. MS-DOS also displays the prompt for the new date: 


Current date is Wed 6/22/85 


Enter new date: __ 


If the date is incorrect, enter the new date. If you do not want to 
change the displayed date, press the Return key. You can also enter 
the DATE command with a date to change the date known to the sys- 
tem. 


mm 
is the number for the month (1 through 12). 


dd 
is the number for the day (1 through 31). 


yy 
is the number for the year (80 through 99, or 1980 through 2099). 
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Separate the month, day, and year with hyphens (-) or slashes (/). If 
you use any symbols other than these, or if you use letters instead of 
numbers, the following message and prompt appear: 


Invalid date 


Enter new date: _ 


You can change the date from the keyboard or from a batch file. If you 
are using an AUTOEXEC.BAT file during MS-DOS startup that does 
not contain the DATE command, however, MS-DOS will not prompt 
you for the date. For this reason, you may want to include the DATE 
command in that file (see ICOMMAND/VCOMMAND in _ this 
chapter). 


Delete Files (DEL) 


DEL [path]filename.ext(cr) 


DEL is an internal command that deletes all files that match the 
specified filename. 


path 
is the path through the subdirectory system to the file you want to 
delete. Include the drive name in the path if the file is not on the 
default drive. 


Enter DEL *.* to delete all the files. MS-DOS displays: 
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Type Y or N followed by a Return to confirm or retract your DEL *.* 
command. 


The following command deletes the file EXAMP.TXT from the TEXT 
subdirectory on drive B: 


del b:\bin\text\examp.txt(cr) 


The following command deletes all the files with .LST extension from 
the current directory on the default drive: 


del *.lst 


Display Directory (DIR) 
DIR [path][[filename][.ext]] [/P] [/W](cr) 


DIR is an internal command. DIR without parameters lists all the files 
in the current (sub)directory on the default drive. 


path 
is the path through the subdirectory system to the subdirectory you 
want to list, or to the file(s) whose existence you want to verify with 
DIR. The path includes the drive name and subdirectory names as 
necessary. 


filename | 
lists all the files with the given name. 


filename.ext 
lists only those files from the root directory with the given name and 
extension. 


/P 


stops listing the directory at one page or screenful of information. 
MS-DOS prompts you to strike any key to continue the listing. 
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/W 
displays five filenames per line across the width of the screen. Only 
the filenames are displayed. 


DIR lists the filenames, their sizes in bytes, and the time and date they 
were last modified, for all the parameters except /W. 


You can use the ? and * wild-card characters (see Chapter 2.5) in the 
place of parts of a filename. For example: 


dir *.* is the same as dir 
dir filename is the same as dir filename.* 
dir .ext is the same as dir *.ext 


The following example shows a sample directory listing. The backslash 
indicates that this is the root directory on drive A. When your current 
or default directory is the root directory on drive A, you can enter the 
DIR command without specifying a drive name. 


A>dir(cr) 


Volume in Drive A is JANUARY 
Diskette is V format 
Directory of A:\ 


STATUS DAT 1-25-85 
COST DAT 1-31-85 
STATUS BAK 1-16-85 
CALENDAR JAN 1-12-85 
MEMOS 1-05-85 
LETTERS 1-10-85 


6 File(s) 141516 bytes free 
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This example shows the same directory listing using the /W option: 


A>dir/w(cr) 


Volume ID for drive A: is JANUARY 
Diskette is V format 
Directory A:\ 


STATUS DAT COST DAT STATUS BAK CALENDAR DAT MEMOS 
LETTERS 
6 File(s) 141516 bytes free 


A>_ 


Disk Comparison (DISKCOMP) 
(I mode only) 


DISKCOMP [d:] [d:] [/1] [/8](cr) 


DISKCOMP is an external command that compares the contents of a 
diskette in one drive with the contents of a diskette in another drive. 
DISKCOMP can be used only with floppy diskettes. DISKCOMP 
always compares two entire diskettes to each other. 


d: 
is an optional drive letter giving the names of the diskettes that you 
want to compare. 


/1 
compares only the first side of two disks even if double-sided 
diskettes are being used. 


[8 


compares only 8 sectors per track even if 9-sector-per-track diskettes 
are 1n use. 
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Use the DISKCOMP command to verify that the DISKCOPY com- 
mand has accurately copied the contents of one diskette onto another 
diskette. 


You should not use DISKCOMP when the COPY command was used 
to copy a diskette. Although the contents of the two diskettes created 
with COPY might be identical, the arrangement of the data on each 
diskette might not be exactly the same. In this case, DISKCOMP indi- 
cates that corresponding tracks on the disks do not compare even 
though all files might have been accurately copied. 


When you enter DISKCOMP, you can specify one or two drives. If 
you specify only one drive, DISKCOMP performs a single-drive com- 
parison. Use this command if you have a system with one diskette 
drive and a fixed disk drive. MS-DOS prompts you to insert diskettes 
at the appropriate time. After giving the prompt, MS-DOS waits for 
you to press any key. 


If DISKCOMP finds a discrepancy between the disks, you will see this 
message: 


Compare Error(s) on 


Track nn, Side x 


where nn is the track number (0 through 39), and x is the side of the 
diskette (0 or 1) on which the discrepancy was found. 


If the disks compare exactly, the following message is displayed: 


Diskettes compare OK 
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If you do not specify any parameters, a single-drive comparison is 
done using the default drive. If the second drive name is omitted, the 
default drive becomes the second drive. If the default drive is specified 
as the first drive name, a single-drive procedure is used. 


When you attempt to compare diskettes on a single-drive system, all 
prompts are for drive A, regardless of the parameters you specify. 


Dual Drive Disk Copy (DISKCOPY) 
(V mode only) 


DISKCOPY [side to side](cr) 


DISKCOPY is an external command that copies the contents of a 
VICTOR format diskette in one drive onto a diskette in another drive. 
You do not have to prepare the destination diskette with FORMAT 
before you use DISKCOPY; DISKCOPY formats the destination 
diskette automatically. During the copying process, DISKCOPY 
displays the number of the track being copied. 


If you enter DISKCOPY without parameters, the program prompts 
you to: 

> Name the drive (left or right) containing the diskette to be copied. 

> Press the space bar to start the copy process. 

> Repeat the process after the copy is complete. 

The following example copies the diskette in the left drive (A) to the 
diskette in the right drive (B). Screen prompts are shown in the order 


they appear on the screen, but their position on the screen is not 
shown 1n the example. 
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A>diskcopy(cr) 


Diskette COPY Utility -- Version ms x.y 


Copy from FLOPPY drive? (Left or Right; press RETURN 
to end)l 


Copy from Left FLOPPY drive to Right FLOPPY drive. 
Press space bar when ready.(sp) 


Copy from Left FLOPPY drive to Right FLOPPY drive 


Copy from Left FLOPPY drive to Right FLOPPY drive 
complete. 


Copy from FLOPPY drive? (Left or Right; press RETURN 
to end)(cr) 


A>_ 


If you follow the steps shown in the previous example, you can remove 
the system diskette from the left drive after DISKCOPY loads into 
memory. This also means that once the “Diskette COPY Utility” 
sign-on message appears, you can use either drive for the source or des- 
tination diskette. In this way you can load DISKCOPY from your sys- 
tem diskette and then insert another diskette that you want to copy. 


side to side 
is an optional phrase naming the drives containing the source and 
destination diskettes. This phrase pertains to two-drive systems. If 
you have a one-drive system with a fixed disk, insert the destination 
diskette into the drive and enter the appropriate drive letter. The 
phrase can take either of these two forms: 


left to right 
right to left 
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You can abbreviate this phrase to letters. You can use L and R to 
represent left and right, and you can use T instead of TO, or you 
can omit the T entirely. For example, these three commands copy 
the diskette in the right drive to the diskette in the left: 


diskcopy r to | 
diskcopy r t | 
diskcopy r | 


If you include the drive sides in a DISKCOPY command, DISKCOPY 
loads into memory and begins copying immediately, so that you have 
no opportunity to swap diskettes. For this reason, you should include 
the drive parameters only if you are copying your system diskette (the 
diskette containing DISKCOPY). 


If there have been many file deletions and creations on the diskette 
you are copying, the disk is fragmented. Fragmentation occurs because 
disk space is not always allocated sequentially when files are created. 
Access time for a fragmented diskette is slower than for a diskette with 
consolidated file. You can consolidate files on a fragmented diskette by 
using the COPY command instead of DISKCOPY. 


For example, the following COPY command copies all the files from 
the diskette in drive A to the diskette in drive B: 


copy a:*.* b:(cr) 


Note that you cannot copy your operating system diskette using *.* 
because the system files are not copied. 
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Echo Messages to Display (ECHO) 


ECHO ON(cr) 
or 

ECHO OFF(cr) 
or 


ECHO message(cr) 


ECHO is an internal command for batch files that controls the display 
of batch file commands and comments during batch file processing. 
ECHO without parameters specifies the current setting (ON or OFF). 


ON 
displays all batch commands and remarks (REM) during batch file 
processing. ECHO ON is the default. 


OFF 
turns off display of the commands in the batch file. The command 
(such as A> ECHO OFF) is displayed, but any batch commands 
following this command are not displayed. 


message 
is a string of alphanumeric characters that you want displayed dur- 
ing batch file processing, for example: 


copy con greet.bat(cr) 
echo Welcome aboard!(cr) 
echo Enter your name.(cr) 
“Z(cr) 


These commands copy the two ECHO command lines to a batch 


file called GREET.BAT. A CTRL-Z (*Z) closes the file and returns 
you to the MS-DOS system prompt. 
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When you specify GREET, MS-DOS displays: 


A>echo Welcome aboard! 
Welcome aboard! 


A>echo Enter your name. 
Enter your name. 


You can include ECHO OFF in a batch file to suppress just the display 
of the batch commands. And, in the same file, you can specify ECHO 
with a message to display that message during batch processing. For 
example, if you add ECHO OFF to the GREET.BAT file above: 


copy con greet.bat(cr) 
-echo off(cr) 

echo Welcome aboard!(cr) 
echo Enter your name.(cr) 
“Z(cr) 


and enter GREET from the keyboard, MS-DOS displays only the mes- 
sages following each ECHO command: 


A>echo off 


Welcome aboard! 
Enter your name. 


Erase Files (ERASE) 


ERASE [path]filename.ext(cr) 


ERASE is an internal command that deletes all files that match the 
specified filename. See the DEL command in this chapter. 
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Convert Executable Files to Binary Files 
(EXE2BIN) 


EXE2BIN [path]filename.ext [[path][filename[.ext]]](cr) 


EXE2BIN is an external command that converts linker-generated 
.EXE (executable) files to binary (.COM) format. This procedure saves 
disk space and provides faster program loading. 


The resident (actual code and data) part of the .EXE file must be less 
than 64K. The input file is converted to .COM file format (memory 
image of the program) and placed in the output file. The input file 
must be in valid .EXE format produced by the linker. There must be 
no STACK segment. 


path 
is the path through the directory hierarchy to the file that you want 
to specify as the input file or the output file. 


filename.ext 
is the name of the input file. It can also be the name of the con- 
verted file. If you do not specify a file extension with the input 
filename, it defaults to .EXE. If you do not specify an output 
filename, the input filename is used. If you do not specify a file 
extension in the output filename, the new file’s extension is .BIN. 


Two kinds of conversions are possible, depending whether the initial 
CS:IP (Code Segment:Instruction Pointer) is specified in the .EXE file: 


1. If CS:IP is not specified in the .EXE file, a pure binary conversion is 
assumed. If segment fixups are necessary (for example, the program 
contains instructions requiring segment relocation), you will be 
prompted for the fixup value. This value is the absolute segment at 
which the program is to be loaded. You can use the resulting pro- 
gram only when loaded at the absolute memory address specified by 
a user application. The command processor is not capable of load- 
ing the program correctly. 
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2. If CS:IP is specified as 0000:100H, it is assumed that the file is to be 
run as a .COM file with the location pointer set at 100H by the 
assembler statement ORG; the first 100H bytes of the file are 
deleted. No segment fixups are allowed because .COM files must be 
segment relocatable. 


Once the conversion is complete, you can rename the resulting file 
with a .COM extension. Then the command processor can load and 
execute the program in the same way as the .COM programs supplied 
on your MS-DOS diskette. 


Change EXE Header Size (EXESIZE) 


EXESIZE filename [/Nxxxx] [/Xyyyy] [/P](cr) 


The EXESIZE command is an external command that sets a specified 
file’s EXE header values so that it can use MS-DOS memory allocation 
functions. 


If your program needs to allocate additional memory space, or it 
requires statically allocated memory, specify the hexadecimal number 
of 16-byte paragraphs with the /N and /X options. If your program’s 
linker-produced EXE header value does not explicitly define statically 
allocated memory, such as the stack/heap area of some high-level 
languages, use /N and /X. 


If you do not specify /N or /X, EXESIZE assumes that the file does 
not need additional memory space, and thus sets the memory space 
required to the size of the EXE file itself. 


filename 
is the name of the file for which you want to set the EXE header 
values. If you do not specify a file extension, it is assumed that the 
file is an .EXE file. 
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/N 
is the minimum amount of memory space needed for the program 
to run, where xxxx is any hexadecimal number. 


/X 
is the maximum amount of memory space that the program can use 
to run, where yyyy is any hexadecimal number. 


/P 
causes the screen display to pause if EXESIZE encounters an error. 


Exit ICOMMAND.COM/VCOMMAND.COM 
(EXIT) 


EXIT(cr) 
EXIT is an internal command. You can use this command to return 


from ICOMMAND.COM/VCOMMAND.COM to the program or to 
the command processor you were using previously. 


If you are in V mode, and MS-DOS is processing a program that 
allows you to call the VCOMMAND.COM program, you enter: 


vcommand(cr) 


to invoke VCOMMAND.COM. You can now use any internal com- 
mand. To return to the previous program, specify: 


exit(cr) 


Note: If you are in I mode, you specify ICOMMAND to call 
ICOMMAND.COM, but the EXIT command remains the same. 
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Fast Expression Search (FGREP) 


FGREP [options] expression [files or directories](cr) 


FGREP.EXE is an external command (utility) that searches through a 
list of files for files that contain a specific text string. FGREP outputs 
the lines that contain the text string and the names of the files. Options 
allow you to search subdirectories, list only filenames, and list the 
number of lines that match. 


Options can be any of the following: 


r 


matches only text at the beginning of a line. 


/$ 


matches only text at the end of a line. 


/C 
prints only a count of the lines containing matching text. 


/I 


ignores upper/lowercase when matching the expression. 


/L 
also prints line numbers for matching text in files. 


/N 
prints only the filenames of files with matching text. 


/R 
recursively searches subdirectories of the directories in the [files or 
directories] list. If you do not include this option, FGREP searches 
only the files you name in the command, as well as all files in any 
directories named in that command. 
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/V 
reverses the match—prints all lines except those with a matching 
expression. 


/W 
matches only text that is a word (or two words) not preceded by a 
letter, digit, or underscore. 


expression 
is the text string to search for. If the expression does not contain 
spaces or wild-cards, you can specify this string exactly as you want 
it to appear in the files—that is, without delimiters such as quotes. 
For example: 


fgrep jack a:chapt1.doc(cr) 
searches for ‘“‘jack” in the file CHAPT1.DOC on drive A. 
If the expression contains spaces, hyphens, or MS-DOS command- 
line characters (such as < or >), you must enclose the string in 
double quotes. For example: 


fgrep “a jack-in-the-box” *.pas(cr) 


searches all files with the .PAS extension for “‘a jack-in-the-box’, an 
expression containing spaces and hyphens. 


files or directories 
is a list of one or more subdirectory names and/or filenames which 
can include wild-card characters. This list specifies the domain on 
which the FGREP command will operate. If no files are given, 
FGREP accepts keyboard input or redirected input to search. 

For example: 


fgrep /i'$ proc c:\sources d:\project\*.asm(cr) 


ignores upper/lowercase (/I) and prints a list of files and their lines that 
begin (/*) and end (/$) with (i.e., consist only of) the string “proc’’. 
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Files in the directory C:\SOURCES and in the D:\PROJECT directory 
with the .ASM file extension are searched. 


This command: 
fgrep /ri proc c:\sources d:\project\*.asm(cr) 


is similar to the previous example, except that any subdirectories (/R) 
of C:\SOURCES and their subdirectories will also be searched. 


The following command: 

fgrep /vn priority c:\memos d:\*.not(cr) 
outputs the names of files (/N) which have lines that do not contain 
(/V) the word “priority”. FGREP searches the \MEMOS subdirectory 


on drive C, and all files with .NOT extension in the root directory on 
drive D. 


File Comparison (FILCOM) 


FILCOM [/#] [/B] [/C] [/W] file1 file2(cr) 


File Comparison (FILCOM.EXE) compares the contents of two files. 
You can abbreviate FILCOM to FC. You can compare disk files if you 
have two copies and you want to see which one is current. FILCOM 
outputs the differences between the two files to the console or to a 
third file. The files can be source files (files containing source state- 
ments of a programming language) or binary files (output by an assem- 
bler, the linker, or a high-level language compiler). 


The comparison can be made in one of two ways: line by line or byte 
by byte. The line-by-line. comparison isolates blocks of lines that are 
different between the two files and prints those blocks of lines. The 
byte-by-byte comparison displays the bytes that are different between 
the two files. 
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FILCOM matches FILE! against FILE2 and reports any differences 
between them. Both filenames can include pathnames. For example: 


fc b:\mgr1.nam\ted\f1.asm \mgr2.nam\f2.asm(cr) 


compares F1.ASM in the \MGR1.NAM\TED subdirectory on drive B 
with F2.ASM in the \MGR2.NAM subdirectory on the disk in the 
default drive. 


/# 
is a number from | to 9. This switch specifies the number of lines 
required to match for the files to be considered as matching again 
after a difference has been found. If /# is not specified, it defaults to 
3. /# is used only in source file comparisons. 


/B 
forces a binary comparison of both files. The two files are compared 
byte-to-byte, with no attempt to resynchronize after a mismatch. 
The mismatches are printed as follows: 


~-ADDRS----F1----F2-- 


XXXXXRKX NA‘ ZZ 


where xxxxxxxx is the relative address of the pair of bytes from the 
beginning of the file. Addresses start at 00000000; yy and zz are the 
mismatched bytes from FILE1 and FILE2, respectively. If one of 
the files contains less data than the other, a message is printed out. 
For example, if FILE1 ends before FILE2, FILCOM displays: 


***Data left in F2*** 


1s 
ignores the case of letters. All letters in the files are considered 
uppercase. This switch is used only in source comparisons. 
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For example: 

Much MORE data IS NOT FOUND 
matches with: 

much more data is not found 

/W 

compresses “whites” (tabs and spaces) during the comparison. Thus, 
multiple contiguous spaces in any line are considered a single space. 
Note that although FILCOM compresses spaces, it does not ignore 
them. FILCOM ignores beginning and ending spaces in a line. /W is 


used only in source comparisons. In this example an underscore 
represents a blank space: 


___More—data_to_be_found____ 
matches with: 


More—data_to_be_found 


and with: 


More_____—-_ data_to_be_____found___— 


but will not match with: 
Moredata_to_be_found 


If both /W and /C are specified, FILCOM compresses tabs and 
spaces, and ignores case. For example: 


—___ DATA_was_found___ 
matches with: 


data_was_found 
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filel file2 
are the full filenames and paths for the two files you want to com- 
pare. If the file is in the current directory on the default drive, you 
can omit the drive and directory names for that file. 


FILCOM reports the differences between the two files you specify by 
displaying the first filename, followed by the lines that differ between 
the files, followed by the first line to match in both files. FILCOM then 
displays the name of the second file followed by the lines that are 
different, followed by the first line that matches. For example: 


<filenamel> 
<difference> 
<lst line to match file2 in filel> 


<filename2> 


<difference> 
<lst line to match filel in file2> 


FILCOM continues to list each difference. 


If there are too many differences (involving too many lines), the pro- 
gram reports that the files are different and stops. 
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If there are no matches after the first difference is found, FILCOM 
displays: 


*¥*¥* Files are different *** 


A>_ 


The differences and matches between the two files are displayed on 
your screen unless you redirect the output to a file. You can redirect 
FILCOM output with the > and < symbols as described in Chapter 
5. For example, to compare F1.TXT and F2.TXT and then send the 
FILCOM output to DIFFER.TXT, type: 


fe f1.txt f2.txt > differ.txt(cr) 


FILCOM uses a large amount of memory as buffer (storage) space to 
hold the source files. If the source files are larger than available 
memory, FILCOM compares what can be loaded into the buffer space. 
If no lines match in the portions of the files in the buffer space, 
FILCOM displays only the message: 


**¥* Files are different *** 


For binary files larger than available memory, FILCOM compares both 
files completely, overlaying the portion in memory with the next por- 
tion from disk. All differences are output in the same manner as those 
files that fit completely in memory. 
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Find Alphanumeric Characters (FIND) 


FIND [/C] [/N] [/V] “string” [path]filename.ext...(cr) 


FIND.EXE is an external command for filtering data. This command 
searches a file to find a specified string of alphanumeric characters and 
displays all the lines on the screen that contain the specified string. 


/C 
displays only the number of matches with the string. The lines that 
match the string are not displayed. 


/N 
displays the relative number of the line(s) that match the string. 
FIND displays the relative line number, then the line. 


/V 
displays the lines that do not contain the string. 


“string” 
is a string of alphanumeric characters that you want to find. The 
characters must be enclosed in quotes. If they are already enclosed 
in quotes, use double quotes to specify the characters as the string 
parameter. 


path 
is the path through the directory hierarchy to the file(s) to be 
searched for the string. 


filename.ext 
is the name of the file or files to be searched for the specified string. 
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The following example searches a mail list file for ‘Washington, D.C.” 
You can create MAIL.LST by entering: 


copy con mail.lst(cr) 

George Washington, Washington, D.C.(cr) 
Charles de Gaulle, Paris, France(cr) 
Pierre Trudeau, Montreal, Canada(cr) 
Abraham Lincoln, Washington, D.C.(cr) 
Margaret Thatcher, London, England(cr) 
Ronald Reagan, Washington, D.C.(cr) 
“Z(cr) 


Then enter: 
find “Washington, D.C.” mail.|st(cr) 


On the first line MS-DOS displays a dashed line, the path to the file if 
one was specified, and the name of the file: 


mail.lst 


MS-DOS then displays each line containing the string ‘““Washington, 
D.C.” 


If MS-DOS cannot locate the FIND command, MS-DOS displays: 


Bad command or filename 


FIND is an external command that may be in another subdirectory. 
Enter a PATH command giving the location of the external command 
FIND. 
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If MS-DOS displays: 


FIND: File not found mail.lst 


the MAIL.LST file is in a subdirectory. You need to specify the path to 
the file. 


The FIND command can also filter data from an input source and 
pipe it to an output source (see Chapter 5.3.1). For example, you can 
find the characters ‘““Washington, D.C.” and pipe them to an output 
file called USPRES.DAT: 


find “Washington, D.C.” mail.lst | sort > uspres.dat(cr) 


The | tells MS-DOS to use the output from the FIND command as 
input to the SORT command. 


Use the DIR command after you have piped data to verify that the file 


is in the directory that you want. If it is not, use the COPY command 
to put the file in the correct directory. 
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For Each One Repeat MS-DOS Command 
(FOR-IN-DO) 


FOR %%variable IN (set) DO command % Yvariable(cr) 


FOR is an internal command used in batch files. It can also be used 
interactively. FOR repeats the specified MS-DOS command for each 
member in the specified set. 


%%variable 

is a dummy variable where “variable” can be any character except 
the numbers 0-9 (which are used for the replaceable batch parame- 
ters, %0-%9). %%variable is replaced by each sequential member in 
the specified set. The variable specified at the beginning of the com- 
mand line must be the same as the last variable in the command 
line. For example, if you specify %%A for the first variable parame- 
ter and %%F for the last variable parameter, MS-DOS displays: 


IN 
tells MS-DOS to sequentially replace %%variable with each sequen- 
tial member in the specified set. 


(set) 
can be any alphanumeric characters, including the replaceable batch 
parameters %0-%9. The set contains more than one member and 
must be enclosed in parentheses: 


(mgr1 mgr2 mgr3) 


You cannot specify a path in the set. 
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DO 
tells MS-DOS to process the command that follows. 


command 
is an MS-DOS command. 


For example, with FOR you can create a batch file that makes a new 
directory, changes the directory, and makes subdirectories: 


copy con mgrdir.bat(cr) 

mkdir %1(cr) 

chdir %1(cr) 

for %%a in (%2 %3 %4) do mkdir %%a(cr) 
“Z(cr) 


To process the file, enter the batch filename (MGRDIR) and the sub- 
directory names you want to create: 


mgrdir managers mgr1 mgr2 mgr3(cr) 


MANAGERS replaces %1, MGR1 replaces %2, MGR2 replaces %3, 
and MGR3 replaces %4. %%A is replaced by the first member of the 
set, which is MGR1. The command then tells MS-DOS, “FOR MGR1 
IN (MGRI1 MGR2 MGR3) DO MKDIR MGRI1.” MGRI1 (%%A) is 
then replaced by MGR2, and MGR2 is replaced by MGR3. 


MS-DOS displays each batch command as it executes: 


A>mkdir managers 

A>chdir managers 

A>for Za in (mgrl mgr2 mgr3S) do mkdir Za 
A>mkdir mgrl 


A>mkdir mgr2 
A>mkdir mgr3 
A>_ 
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